home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / PROGRAMM / BASIC / 2905.ZIP / QWEZ.ZIP / QUICKREF.DOC < prev    next >
Text File  |  1993-06-01  |  33KB  |  1,057 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                            Quick Reference Guide
  29.                         For use with WINDOWS R-E-Z
  30.                     QuickBasic 4.5 and BASIC 7.1 (PDS)
  31.                          Visual BASIC for DOS 1.00
  32.                                Version 6.10
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.                              Copyright (c) 1988 - 1993 by:
  51.                              CONNECT Software
  52.                              All rights reserved
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                        ( See WIND_REZ.DOC for details. )
  61.            ( All routines are sub-routines unless noted otherwise. )
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.     =====================================================================
  72.                          Window Management System
  73.     =====================================================================
  74.  
  75.     BOXW ( ROW%, COL%, WID%, NR%, BORDER% )
  76.          Prints a box in the active window.
  77.  
  78.          ROW% is the row position in the active window for the top
  79.          row of the box.
  80.          COL% is the column position in the active window for the
  81.          left border of the box.
  82.          WID% is the width of the box.
  83.          NR% is the number of rows in the box.
  84.          BORDER% = 1, 2 or 0 for a single, double line or no border.
  85.  
  86.     --------------------------------------------------------------------
  87.  
  88.     CHNGWIND (W%)
  89.         Changes the active window to a new window.
  90.  
  91.         W% is the new active window number.   ( 1 to 20 )
  92.  
  93.     --------------------------------------------------------------------
  94.  
  95.     CLRWIND
  96.         Clears the interior of the active window.
  97.  
  98.     --------------------------------------------------------------------
  99.  
  100.     DELWIND (W%)
  101.         Deletes a saved window from window memory.
  102.  
  103.         W% is the window number to delete.    ( 1 to 20 )
  104.     --------------------------------------------------------------------
  105.  
  106.     LINEW (ROW%, TYP%)
  107.         Prints, or erases, a horizontal line in the active window.
  108.  
  109.         ROW% is the row in the window in which the line will print.
  110.         TYP% = 1 for single line, 2 for double line, 0 to erase a line.
  111.  
  112.     --------------------------------------------------------------------
  113.  
  114.     MAKEWIND (W%, TITLE$, TR%, LC%, WD%, NR%, ATTR%, BORD%)
  115.         Makes a window and optionally saves a windowed area.
  116.  
  117.         W% is the assigned window number.  ( 0 to 20 )  "0" is not saved.
  118.         TITLE$ is the window's title.
  119.         TR% is the window's top row.       ( 1 to display rows or 100 )
  120.         LC% is the window's left column.   ( 1 to 78 or 100 )
  121.         WD% is the window's width.         ( 3 to 80 )
  122.         NR% is the number of rows.         ( 3 to display rows )
  123.         ATTR% is the window's color designation.  ( 0 to 255 )
  124.         BORD% is the border designation. (0-2, 10-12, 20-22, 30-32,
  125.                40-42, 100-102, 110-112, 120-122, 130-132, 140-142 )
  126.  
  127.     --------------------------------------------------------------------
  128.  
  129.  
  130.                                      1
  131.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  132.  
  133.  
  134.  
  135.  
  136.  
  137.     =====================================================================
  138.                      Window Management System - Cont.
  139.     =====================================================================
  140.  
  141.     NEWCOLOR (ATTR%)
  142.         Changes the "print-to" color of the active window.
  143.  
  144.         ATTR% is the new "print-to" color. ( 0 to 255 )
  145.  
  146.     ---------------------------------------------------------------------
  147.  
  148.     PRINTW (TEXT$, ROW%, COL%)
  149.         Prints text in the active window.
  150.  
  151.         TEXT$ is the text to print in the active window.
  152.         ROW% is the row in the window in which the text will print.
  153.         COL% is the column in the window where the text print starts .
  154.  
  155.     --------------------------------------------------------------------
  156.  
  157.     PRINTWHOT (TEXT$, ROW%, COL%, CHAR%, ATTR%)
  158.         Prints text in the active window - with a "hot character".
  159.  
  160.         TEXT$ is the text to print in the active window.
  161.         ROW% is the row in the window in which the text will print.
  162.         COL% is the column in the window where the text print starts .
  163.         CHAR% is the position in TEXT$ of the "hot character".
  164.         ATTR% is the color of the "hot character".
  165.  
  166.     ---------------------------------------------------------------------
  167.  
  168.     RESAVE
  169.         Saves the active window and interior of same in window memory.
  170.         Replaces the area covered by the active window in window memory.
  171.  
  172.     --------------------------------------------------------------------
  173.  
  174.     RSTRWIND (W%, DELFLAG%)
  175.         Restores a window from window memory to the display.
  176.  
  177.         W% is the window number to restore.    ( 1 to 20 )
  178.         DELFLAG% = 1 to remove the window (W%) from window memory.
  179.                    0 to leave the window (W%) in window memory.
  180.  
  181.     --------------------------------------------------------------------
  182.  
  183.     SAVEWIND (W%, TR%, LC%, WD%, NR%)
  184.         Saves an area from the display to window memory.
  185.  
  186.         W% is the window area's assigned number.  ( 1 to 20 )
  187.         TR% is the top row.                  ( 1 to display rows or 100 )
  188.         LC% is the left column.              ( 1 to 78 or 100 )
  189.         WD% is the width.                    ( 3 to 80 )
  190.         NR% is the number of rows.           ( 3 to display rows )
  191.  
  192.     ---------------------------------------------------------------------
  193.  
  194.  
  195.  
  196.                                      2
  197.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  198.  
  199.  
  200.  
  201.  
  202.  
  203.     =====================================================================
  204.                      Window Management System - Cont.
  205.     =====================================================================
  206.  
  207.     SETWIND (FAST%, SND%, SHAD%, NOHI%, BRACKETATTR% )
  208.         Sets window memory, sound, and display update speed.
  209.  
  210.         FAST% = 1 for fast screen updates, 0 for slow CGA screen updates.
  211.         SND% = 1 for "click", 2 for "beep", and 0 for no sound.
  212.         SHAD% is the window shadow color. ( 0 to 255 )
  213.         NOHI% = 1 for no high intensity characters ( LCD displays )
  214.               = 0 for normal high intensity characters.
  215.         BRACKETATTR% sets the bracket ( < > ) foreground color for
  216.                      buttons for INPTWIND, SCRLWIND, CHOICEWIND% and
  217.                      CHOICEBAR%. ( 0 to 15 )
  218.  
  219.     --------------------------------------------------------------------
  220.  
  221.     WAVAIL% (WINDOW%)     *** FUNCTION ***
  222.         Returns 1 if a window is available, 0 if it is not available.
  223.  
  224.         WINDOW% is the window number. ( 1 to 25 )
  225.  
  226.     --------------------------------------------------------------------
  227.  
  228.     WINDSTATUS
  229.         Display the status of windows saved in window memory.
  230.  
  231.     --------------------------------------------------------------------
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                                      3
  263.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  264.  
  265.  
  266.  
  267.  
  268.  
  269.     =====================================================================
  270.                              Pulldown Windows
  271.     =====================================================================
  272.     CHNGPULL (BARITEM%, WINDITEM%, ATTR%)
  273.         Makes a pulldown window selection active or inactive.
  274.  
  275.         BARITEM% is the number of the pulldown menu bar selection.
  276.         WINDITEM% is the number of the pulldown window selection.
  277.                   = -1 to affect all pulldown window selections.
  278.         ATTR% = 0 for active selection with original color.
  279.                 1 to 127 for inactive selection with new color.
  280.  
  281.     --------------------------------------------------------------------
  282.     SETPULL (TR%, LC%, WD%, PWIND$() )
  283.         Set up routine for pulldown windows
  284.  
  285.         TR% is the top row of the menubar.    ( 1 to display rows - 4 )
  286.         LC% is the left column position of the menubar. ( 1 to 73 )
  287.         WD% the menubar's width.  ( Maximum of 81 - LC% )
  288.         PWIND$() is the array holding the data for the pulldown menubar,
  289.                  menubar's info-line, and pulldown window's selections.
  290.  
  291.     --------------------------------------------------------------------
  292.     PRINTMENUBAR ( ATTR% )
  293.         Prints the pulldown menu bar as specified in the call to SETPULL
  294.         for the pulldown windows.  Only required if the "ALT KEY" method
  295.         is used to enter pulldown.
  296.  
  297.         ATTR% is the menubar's color. ( 1 to 127 )
  298.  
  299.     --------------------------------------------------------------------
  300.  
  301.     PULLDOWN (INFO$(),MENUBAR%,WINDITEM%,EXIT$,RKEY%,ATTR%,KEYATTR%,BRDR%)
  302.         Places user in the pulldown window environment.
  303.  
  304.         INFO$() holds the pulldown window's selections info-line data.
  305.         MENUBAR% is the selected menu bar item on exit.
  306.         WINDITEM% is the selected pulldown window item.
  307.         EXIT$ sets the exit keys.
  308.         RKEY% represents the key pressed, which caused the exit.
  309.         ATTR% is the color for the pulldown windows.   ( 1 to 127 )
  310.         KEYATTR% is the color for the key characters.  ( 1 to 127 )
  311.         BRDR% is the border designation. ( 0,1,2,10,11,12)
  312.  
  313.     --------------------------------------------------------------------
  314.  
  315.     RSTRPULL ( RSTRMENUBAR% )
  316.         Deactivates the active pulldown window.  Restores the display
  317.         area under the active pulldown window, optionally restoring
  318.         the area under the menubar also.
  319.  
  320.         RSTRMENUBAR% is set to 1 to restore the display area under
  321.                      the menubar, 0 does not restore the area.
  322.  
  323.     --------------------------------------------------------------------
  324.  
  325.  
  326.  
  327.  
  328.                                      4
  329.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  330.  
  331.  
  332.  
  333.  
  334.  
  335.     =====================================================================
  336.                               Scroll Windows
  337.     =====================================================================
  338.  
  339.     B4SCRL ( EXIT$, MARK$, TAGCOL%, NOREFRESH% )
  340.         Provides additional options for a subsequent call to SCRLWIND.
  341.  
  342.         EXIT$ sets those keys or circumstances which will exit SCRLWIND.
  343.               ( Any combination of "0123456789ERIDXTMOA" )
  344.         MARK$ allows selections in a scroll window to be marked on entry.
  345.         TAGCOL% is the foreground color or the tag designator for "Mark"
  346.                 scroll windows. ( 0 to 15 )
  347.         NOREFRESH% = 1 to enter the scroll window without refreshing
  348.                    it's interior or 0 to refresh the interior.
  349.  
  350.     --------------------------------------------------------------------
  351.  
  352.     SCRLWIND ( LIST$(), INFO$(), TL$, ENTRIES%, KIND$, RTRN%, LI%, FC%,
  353.               RKEY%, KEYATTR%, SCROLLBAR%, BUTTON%)
  354.  
  355.     Note: The above call to SCRLWIND must be typed one line in the
  356.           QB/QBX/VBDOS environment.
  357.  
  358.         Places a scrollable list in a window previously made by MAKEWIND.
  359.  
  360.         LIST$() is the list to place in the scroll window.
  361.         INFO$() is the scroll window's selections info-line data.
  362.         TL$ is the top line message for scroll windows with title boxes.
  363.         ENTRIES% is the number of items in LIST$().
  364.         KIND$ sets the type of scroll windows on entry to SCRLWIND.
  365.               "A"=autoexit   "M"=multiple mark    "S"=single mark
  366.               "V","SV"=view/single-mark view      "L"=list only
  367.               Holds coded data for "mark" scroll windows on exit.
  368.         RTRN% sets the highlighted selection on entry.  On exit, it
  369.               returns the sequential item selected from the scroll window.
  370.         LI% sets the interior row position the selected entry will occupy
  371.             on entry.  On exit, it returns the row position occupied by
  372.             the highlighted entry.
  373.         FC% sets the offset from start of the strings ( entries ) to print
  374.             in the first column of virtual scroll window.   On exit, it
  375.             returns the offset from the start of the strings ( entries )
  376.             occupying the first column in virtual scroll windows.
  377.         KEYATTR% is the color for the key characters.  ( 0 to 127 )
  378.                  0 = virtual scroll windows if any selections are
  379.                      wider the window's width minus 4.
  380.                  1 to 127 = non-virtual scroll window
  381.         SCROLLBAR% determines if scroll bars are used.
  382.                    0 = no scroll bars.  1 = use scroll bars
  383.         BUTTON% determines if < OK > < CANCEL > buttons are used.
  384.                 0 = no buttons.  1 = < OK > button.
  385.                 2 = < OK > and < CANCEL > buttons.
  386.  
  387.     ---------------------------------------------------------------------
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.                                      5
  395.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  396.  
  397.  
  398.  
  399.  
  400.  
  401.     =====================================================================
  402.                           Scroll Windows - Cont.
  403.     =====================================================================
  404.  
  405.     MARKED% (RTRN$, START%)   *** FUNCTION ***
  406.         Decodes marked items from a "mark" scroll window.
  407.  
  408.         RTRN$ is the string representing items marked in a scroll window.
  409.         START% is the position in which to start the decoding in RTRN$.
  410.  
  411.     ---------------------------------------------------------------------
  412.  
  413.     SCROLLPRINT ( ROW%, COLUMN%, ATTR% )
  414.         Allows a subsequent call to routine SCRLWIND to print it's
  415.         selected item at any screen location.
  416.  
  417.         ROW% is the row position in which the selected item prints.
  418.         COLUMN% is the column position the selected item starts printing.
  419.         ATTR% is the color of the selected item's text.  ( 1 to 255 )
  420.  
  421.     ---------------------------------------------------------------------
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.                                      6
  461.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  462.  
  463.  
  464.  
  465.  
  466.  
  467.     =====================================================================
  468.                               Input Routines
  469.     =====================================================================
  470.  
  471.     B4INPT ( EXIT$ ,RESTRICT$ )
  472.         Sets parameters for a subsequent call to INPTWIND. Only affects
  473.         the next call to INPTWIND.
  474.  
  475.         EXIT$ sets the exit keys for routine INPTWIND and may equal
  476.               any combination of "0123456789UDER".
  477.         RESTRICT$ restricts input to user defined characters for a
  478.                   subsequent call to INPTWIND.
  479.  
  480.     ---------------------------------------------------------------------
  481.  
  482.     CHOICEBAR% ( C$(), ROW%, COL%, WD%, ATTR%, HATTR%, EX$ )
  483.         ** FUNCTION **
  484.         Displays a choice bar with up to 10 choices.
  485.  
  486.         C$() is an array holding the choices.
  487.         ROW% is the choice bar's row position.
  488.         COL% is the choice bar's left column position.
  489.         WD% is the choice bar's width.
  490.         ATTR% is the choice bar's color.
  491.         HATTR% if the "hot character's" color.
  492.         EX$ provide alternate exit keys. any combination of
  493.             "0123456789UDETO"
  494.  
  495.     ---------------------------------------------------------------------
  496.     CHOICEWIND% ( T$, TXT$(), CH$(), R%, C%, ATTR%, HATTR%, ESC%, BRDR% )
  497.         **FUNCTION**
  498.         Display a text filled window with a choicebar.
  499.  
  500.         T$ is the choice window's title.
  501.         TXT$() is an array holding the text.
  502.         CH$() is an array holding the choices.
  503.         R% is the choice window's top row position,
  504.         C% is the choice window's left column position.
  505.         ATTR% is the choice window's color.
  506.         HATTR% is the color of the "hot character" in the choice
  507.                window's choice bar.
  508.         ESC% is set to 1 to allow ESC to exit or 0 to suppress ESC exit.
  509.         BRDR% = choice window's border designation. SAME AS MAKEWIND.
  510.  
  511.     ---------------------------------------------------------------------
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.                                      7
  527.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  528.  
  529.  
  530.  
  531.  
  532.  
  533.     =====================================================================
  534.                           Input Routines - Cont.
  535.     =====================================================================
  536.  
  537.     GETANS (PROMPT$, CHOICE$, ANS$, TR%, LC%, WATTR%, FATTR%, BRDR%)
  538.         Displays a windowed prompt. Waits for a single key user response.
  539.  
  540.         PROMPT$ is the prompt to place in the get answer window.
  541.         CHOICE$ represents the allowable keys GETANS will recognize.
  542.         ANS$ sets the mode of operation for GETANS on entry.  If ANS$ = ""
  543.              on entry GETANS exits as soon as a valid key is pressed.  If
  544.              ANS$ equals any character the character is displayed on
  545.              entry.  ENTER must be pressed to exit.  On exit, ANS$ returns
  546.              the character (key) selected by the user.
  547.         TR% is the top row of the get answer window.
  548.         LC% is the left column of the get answer window.
  549.         WATTR% is the color of the get answer window.   ( 1 to 255 )
  550.         FATTR% is the color of the field. Only if ANS$ <> "".
  551.         BRDR% is the border designation. (0-2, 10-12, 20-22, 30-32,
  552.               40-42, 100-102, 110-112, 120-122, 130-132, 140-142 )
  553.  
  554.     ---------------------------------------------------------------------
  555.  
  556.     INPTINIT ( DATEFORMAT%, ISDOT%, AT1%, BLANK%, MAKESND%)
  557.         Initializes input memory for routines INPTWIND an MULTINPT.
  558.         Sets user preferences.
  559.  
  560.         DATEFORMAT% sets the allowable date format. ( 1 to 5 )
  561.         ISDOT% equals 1 for a period decimal point, 0 for a comma.
  562.         AT1% determines the cursor position on entry to a field.
  563.              1 = position 1. 0 = end of text.
  564.         BLANK% determines if the first valid character erases the field.
  565.                1 = erase on first character pressed. 0 = don't erase.
  566.         MAKESND% equals 1 for sound on invalid character or 0 for no
  567.                  sound on invalid character.
  568.  
  569.     ---------------------------------------------------------------------
  570.  
  571.     INPTWIND (P$,CODE$,TR%,LC%,WD%,WATTR%,FATTR%,RTRN$,RKEY%,BUT%,BRDR%)
  572.         Places an input window on the display.  Waits for user input.
  573.  
  574.         P$ is the prompt displayed for the input window.
  575.         CODE$ is the code for the type of allowable input.
  576.         TR% is the top row.
  577.         LC% is the left column.
  578.         WD% is the width of the input field.
  579.         WATTR% is the color for the input window.
  580.         FATTR% is the color for the input field.
  581.         RTRN$ is the text entered by the user in the input field.
  582.         RKEY% represents the "exit key". 1 to 13, 27
  583.         BUT% equal the number of buttons. 0 = none. 1 = < OK >.
  584.              2 = < OK > and < CANCEL >.
  585.         BRDR% is the border designation. (0-2, 10-12, 20-22, 30-32,
  586.                40-42, 100-102, 110-112, 120-122, 130-132, 140-142 )
  587.  
  588.     ---------------------------------------------------------------------
  589.  
  590.  
  591.  
  592.                                      8
  593.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  594.  
  595.  
  596.  
  597.  
  598.  
  599.     =====================================================================
  600.                           Input Routines - Cont.
  601.     =====================================================================
  602.  
  603.     MAKEFIELD (SCRN%, FLD%, CODE%, ROW%, COL%, WD%, BASEATTR%, ACTATTR%,
  604.                MATTR%, RES$, EXTO$, HOTPOS%, CURPOS%, BRACKET% )
  605.         ** The above must be on one line in QB/QBX/VBDOS **
  606.         Makes an input field for a MULTINPT.
  607.  
  608.         SCRN% is the mult-field input screen. ( 1 to 10 )
  609.         FLD% is the field number. ( 1 to 150 )
  610.         CODE% is the field type.
  611.         ROW% is the row position of the field.
  612.         COL% is the left column position of the field.
  613.         WD% is the field's width.
  614.         BASEATTR% is the field's inactive color.
  615.         ACTATTR% is the field's active color.
  616.         MATTR% is the field's color while the mouse cursor occupies it
  617.                and the left mouse button is pressed.
  618.         RES$ restricts input to user defined characters. For an
  619.              alpha/numeric field only.
  620.         EXTO$ is a key, when pressed from a non-input type field, moves
  621.               the system cursor to the field.
  622.         HOTPOS% is the character position in a field which assumes the
  623.                 "hot color" set by routine SETINPT.
  624.         CURPOS% is an alternate starting position for the cursor when a
  625.                 field is entered.
  626.         BRACKET% equals 1 to make the first and last characters in a
  627.                  field equal the BRACKETATTR% set by routine SETWIND.
  628.                  Equals 0 for the normal text color.
  629.  
  630.     ---------------------------------------------------------------------
  631.  
  632.     MULTINPT (SCRN%, TOFLD%, CODE$, FROMFLD%, RKEY%, RTRN$() SEL% )
  633.         Displays input fields and waits for user entry.
  634.  
  635.         SCRN% is the assigned multi-field input screen to display.
  636.         TOFLD% = the next active field when entering or exiting MULTINPT.
  637.         CODE$ is set to "VIEW" for view only, "U" to change several
  638.               field movement keys to follow user defined order.
  639.         FROMFLD% sets single field update on entry.  Holds the
  640.                  last active field when MULTINPT exits.
  641.         RKEY% holds the designation for the key which exited MULTINPT.
  642.         RTRN$() is the array holding each input field's data.
  643.         SEL% holds a "mouse only selectable" field number if same cause
  644.              MULTINPT's exit.
  645.     ---------------------------------------------------------------------
  646.  
  647.     RSTRINPT ( RESTOREFLAG% )
  648.         Deactivates the active input window optionally restoring the
  649.         display area under same.
  650.  
  651.         RESTOREFLAG% is set to 1 to restore the display area under the
  652.                      active input window, 0 to not restore it.
  653.  
  654.     ---------------------------------------------------------------------
  655.  
  656.  
  657.  
  658.                                      9
  659.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  660.  
  661.  
  662.  
  663.  
  664.  
  665.     =====================================================================
  666.                           Input Routines - Cont.
  667.     =====================================================================
  668.  
  669.     SETINPT (SCRN%, DISPLEN%, EXIT$, HOTCOL%)
  670.         Set up routine for a multi-field input screen. ( MULTINPT )
  671.  
  672.         SCRN% is the multi-field input screen designation.  (1 - 10).
  673.         DISPLEN% is the display length for the multi-field input screen.
  674.         EXIT$ represents the allowable keys which will exit MULTINPT.
  675.         HOTCOL% is the color of the character specified by the value
  676.                 of HOTPOS% for in field via the call to MAKEFIELD.
  677.  
  678.     --------------------------------------------------------------------
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.                                      10
  725.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  726.  
  727.  
  728.  
  729.  
  730.  
  731.     =====================================================================
  732.                             Directory Routines
  733.     =====================================================================
  734.     DISKSIZE (DRIVE%, SIZE&, FREE&)
  735.         Finds a disk size and free space in bytes.
  736.  
  737.         DRIVE% represents the disk. 1=A, 2=B etc.
  738.         SIZE& is the total number of bytes of storage capacity.
  739.         FREE& is the unused bytes.
  740.  
  741.     --------------------------------------------------------------------
  742.     FINDDIR (PATH$, TYP$. FILE%)
  743.         Places directory listing of any path in a pre-defined array.
  744.  
  745.         PATH$ is the path to search for the directory listing.
  746.         TYP$ specifies file attributes to include in the directory search.
  747.         FILE% holds the number of files found in the directory search.
  748.  
  749.     --------------------------------------------------------------------
  750.     FINDPATH$      ** FUNCTION **
  751.         Returns the current path.
  752.  
  753.         FINDPATH$ returns the current drive and path in the form:
  754.  
  755.         ( DRIVE:\SUB-DIR\....  )
  756.  
  757.         The path always ends with a "\".
  758.  
  759.         Examples:
  760.         B:\       C:\DOS\     D:\GAMES\      A:\
  761.  
  762.     --------------------------------------------------------------------
  763.     GETDISK%       ** FUNCTION **
  764.         Returns the current ( default ) drive.
  765.  
  766.         GETDISK% returns the current drive:  1=A, 2=B, etc.
  767.  
  768.     --------------------------------------------------------------------
  769.     SETDISK (DRIVE%, BADFLAG%)
  770.         Sets the default drive.
  771.  
  772.         DRIVE% is the drive. 1=A, 2=B, etc.
  773.         BADFLAG% = 1 if an attempt was made to set an invalid drive.
  774.  
  775.     --------------------------------------------------------------------
  776.     EXEPATH$       ** FUNCTION **
  777.         Returns the path of the active executable program.
  778.  
  779.         EXEPATH$ returns the executable path as in the following
  780.         form. ( DRIVE:\SUB-DIR\....  )
  781.  
  782.         The path always ends with a "\".
  783.  
  784.         Examples:
  785.         B:\       C:\DOS\     D:\GAMES\      A:\
  786.  
  787.     --------------------------------------------------------------------
  788.  
  789.  
  790.                                      11
  791.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  792.  
  793.  
  794.  
  795.  
  796.  
  797.     =====================================================================
  798.                         Keyboard and Mouse Routines
  799.     =====================================================================
  800.  
  801.     CLEARKB
  802.         Clears the keyboard type ahead buffer.
  803.  
  804.     --------------------------------------------------------------------
  805.  
  806.     GETAKEY%   ** FUNCTION **
  807.         Returns the ASCII/IBM or extended value of a key pressed.
  808.  
  809.     ---------------------------------------------------------------------
  810.  
  811.     LBUTTON%   ** FUNCTION **
  812.         Returns 1 if the left mouse button is pressed or 0 if not.
  813.  
  814.     ---------------------------------------------------------------------
  815.  
  816.     MOUSECOL%  ** FUNCTION **
  817.         Returns the mouse column position of the mouse cursor.
  818.  
  819.     ---------------------------------------------------------------------
  820.  
  821.     MOUSEHIDE
  822.         Hides the mouse cursor.
  823.  
  824.     ---------------------------------------------------------------------
  825.  
  826.     MOUSEINMULT% ( MULTSCRN% )   ** FUNCTION **
  827.         Returns the MULTINPT field number the mouse cursor occupies.
  828.  
  829.         MULTSCRN% is the MULTINPT screen number. ( 1 to 10 )
  830.  
  831.     ---------------------------------------------------------------------
  832.  
  833.     MOUSEINWIND% ( WIND% )      ** FUNCTION **
  834.         Returns a value for the mouse cursor position in a window.
  835.  
  836.         WIND% is the window number. ( 0 to 20 ).
  837.  
  838.     ---------------------------------------------------------------------
  839.  
  840.     MOUSELIMIT ( TR%, BR%, LC%, RC% )
  841.         Set the bounds for mouse cursor movement.
  842.  
  843.         TR% is the top row.
  844.         BR% is the bottom row.
  845.         LC% is the left column.
  846.         RC% is the right column.
  847.  
  848.     ---------------------------------------------------------------------
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.                                      12
  857.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  858.  
  859.  
  860.  
  861.  
  862.  
  863.     =====================================================================
  864.                     Keyboard and Mouse Routines - Cont.
  865.     =====================================================================
  866.  
  867.     MOUSEON% (ISON%)   ** FUNCTION **
  868.         Attempts to turn the mouse on or off.  Returns 1 if the mouse
  869.         driver and mouse are available or 0 if not available.
  870.  
  871.         ISON% = 0 for mouse off, 1 for mouse on.
  872.  
  873.     ---------------------------------------------------------------------
  874.  
  875.     MOUSEPOS ( ROW%, COL% )
  876.         Moves the mouse to a specified display position.
  877.  
  878.         ROW% is the row position.
  879.         COL% is the column position.
  880.  
  881.     ---------------------------------------------------------------------
  882.  
  883.     MOUSEROW%   ** FUNCTION **
  884.         Returns the row position of the mouse cursor.
  885.  
  886.     ---------------------------------------------------------------------
  887.  
  888.     MOUSESHOW
  889.         Makes the mouse cursor visible.  Compliments MOUSEHIDE
  890.  
  891.     ---------------------------------------------------------------------
  892.  
  893.     RBUTTON%    ** FUNCTION **
  894.         Returns 1 if the right mouse button is pressed or 0 if not.
  895.  
  896.     ---------------------------------------------------------------------
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.                                      13
  923.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  924.  
  925.  
  926.  
  927.  
  928.  
  929.     =====================================================================
  930.                             Info-line Routines
  931.     =====================================================================
  932.  
  933.     INFOLINE ( ROW%, LC%, WD%, ATTR% )
  934.         Turns on the info-line.  Saves the display area under same.
  935.  
  936.         ROW% is the row position of the info-line. ( 1 to display rows )
  937.         LC% is the left column position of the info-line ( 1 to 80 )
  938.         WD% is the width of the info-line (1 to 80)
  939.             ( LC% + WD% must equal less than 82 )
  940.         ATTR% is the info-line's color. (1 to 127)
  941.  
  942.     ---------------------------------------------------------------------
  943.  
  944.  
  945.     INFOFIXED ( FIXED$ )
  946.         Defines a fixed info-string, which prints on calls to PRINTINFO.
  947.  
  948.         FIXED$ is the fixed info-string. It will print before any string
  949.                specified in PRINTINFO.
  950.  
  951.     ---------------------------------------------------------------------
  952.  
  953.     PRINTINFO ( MESSAGE$ )
  954.        Prints a message in the info-line.
  955.  
  956.        MESSAGE$ is the message.  It is appended to the fixed info-string
  957.                 if one exists.
  958.  
  959.     ---------------------------------------------------------------------
  960.  
  961.     RSTRINFO ( OFFFLAG% )
  962.        Restores the display area under the info-line. Optionally turns
  963.        off the info-line.
  964.  
  965.        OFFFLAG% is set to one to turn off the info-line, 0 to leave on.
  966.  
  967.     ---------------------------------------------------------------------
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.                                      14
  989.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  990.  
  991.  
  992.  
  993.  
  994.  
  995.     =====================================================================
  996.                               Other Routines
  997.     =====================================================================
  998.     CUROFF
  999.         Hides the system cursor.
  1000.  
  1001.     --------------------------------------------------------------------
  1002.     DISPLAYROWS%  ** FUNCTION **
  1003.         Returns the number of display rows for the active screen mode.
  1004.  
  1005.     --------------------------------------------------------------------
  1006.     DOSOUND
  1007.         Makes the default sound.
  1008.  
  1009.     --------------------------------------------------------------------
  1010.     GETCUR&       ** FUNCTION **
  1011.         Returns a long integer representing the system cursor's size
  1012.         and position.
  1013.  
  1014.     --------------------------------------------------------------------
  1015.     PEEKASM& ( SEGMENT&, OFFSET&, NUMOFBYTES% )     ** FUNCTION **
  1016.         Returns a long integer holding the value of a specified number
  1017.         of bytes at a specified memory location.
  1018.  
  1019.         SEGMENT& is the segment. ( DOS convention )
  1020.         OFFSET& is the offset from SEGMENT&
  1021.         NUMOFBYTES% is the number of bytes to read, ( 1 to 4 )
  1022.  
  1023.     --------------------------------------------------------------------
  1024.     SETCUR ( CURINFO& )
  1025.         Restores the cursor position and size.
  1026.  
  1027.         CURINFO& is a long integer returned from function GETCUR&
  1028.  
  1029.     --------------------------------------------------------------------
  1030.     TWOPOWEROF& (EXPONENT%)   ** FUNCTION **
  1031.         Returns a long integer representing 2 to the "Nth" power.
  1032.         Does not use BASIC's floating point library.
  1033.  
  1034.         EXPONENT% is the exponent for the number 2.
  1035.  
  1036.     --------------------------------------------------------------------
  1037.     WTIMER&       ** FUNCTION **
  1038.         Returns the systems 1/18th second timer as a long integer.
  1039.  
  1040.     --------------------------------------------------------------------
  1041.     WVAL&        ** FUNCTION **
  1042.         Returns a long integer representing the value of a numneric
  1043.         string.  Does not use BASIC's floating point library.
  1044.  
  1045.     --------------------------------------------------------------------
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.                                      15
  1055.      Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
  1056.  
  1057.